5.3.1 출금 시 역서명 확인

#간단한 설명: 사용자가 출금 요청을 시작하면 판매자 플랫폼은 서명 데이터(예: 거래 주문)를 생성하고 처리를 위해 백그라운드로 보냅니다. 데이터가 변조되지 않았는지, 요청 소스가 합법적이고 신뢰할 수 있는지 확인하기 위해 백엔드는 요청 콘텐츠에 대해 "역서명 확인" 작업을 수행해야 합니다.

역서명 확인 설정: 판매자가 직접 설정하려면 판매자 백엔드에 로그인해야 합니다(로그인 정보는 운영 직원에게 문의하세요).


단계 지침

1. 판매자가 판매자 백엔드에 로그인합니다.
2. 네비게이션 바에서 가맹점 관리를 클릭하세요.
3. 판매자 설정을 클릭하세요.
4. 클릭하여 API 스위치를 켜고, 사용자 정의 요청 URL과 키를 입력하고 저장합니다.

요청 설명

• 요청방법 : POST
• 요청 인터페이스 : 가맹점에서 제공
• 요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json

참고: 판매자가 API 보안을 설정하지 않은 경우 이 비즈니스를 처리할 필요가 없습니다. (필수)

요청 매개변수

매개변수 이름	유형	필수	매개변수 의미	매개변수 설명
key	string	예	판매자 키	API키
localOrderId	string	예	판매자 플랫폼 현지 주문 번호	판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
localUserId	string	아니요	판매자 플랫폼 로컬 사용자 ID	판매자 플랫폼 로컬 사용자 ID
amount	number	예	주문금액	출금금액
network	string	예	메인넷	메인넷(현재 TRON, BSC, POLYGON, ETHEREUM만 지원)
address	string	예	출금주소	출금주소
notifyUrl	string	아니요	콜백 주소	주문이 성공적으로 완료되면 API 콜백을 통해 판매자의 주소가 통보됩니다.| (콜백 내용은 문서 3 참조)
nonce	string	예	무작위 문자열	무작위 문자열
currency	string	예	통화	통화(지갑은 디지털 통화를 지원함)
successRedirectUrl	string	아니요	주소	성공 후 해당 주소로 자동 점프
isBlockchain	boolean	아니요	블록체인 정보 반환 여부(기본값 false)	true인 경우 콜백 요청은 주문 체인에 거래 정보를 전달합니다

json 샘플 요청

{
  "amount": 30,
  "isBlockchain": true,
  "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "merchantId": 303675535978,
  "notifyUrl": "http://conan.test/notify",
  "currency": "USDT",
  "localOrderId": "CONAN-9999",
  "merchantCurrency": "USDT",
  "nonce": "MapDwK",
  "key": "dNNTJZpgFVWlYrVv",
  "network": "TRON"
}

참고: 시스템 요청(가맹점 역서명 확인 경로) 매개변수는 판매자 출금 요청 매개변수와 일치합니다. (필수)

응답 예

 "2b703624f24962f5a12d5d1f7569447a"

응답 결과 설명: 응답은 요청 매개변수와 가맹점의 맞춤형 역서명 확인키를 암호화하여 생성된 암호화된 문자열인 암호화된 문자열입니다(암호화 알고리즘은 문서 2 서명 방법 참조). (필수)